home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat1 / dmedia / avcapture.z / avcapture
Encoding:
Text File  |  1998-10-30  |  12.2 KB  |  265 lines

  1.  
  2.  
  3.  
  4. aaaavvvvccccaaaappppttttuuuurrrreeee((((1111))))                                                      aaaavvvvccccaaaappppttttuuuurrrreeee((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      avcapture - capture and synchronization tool for uncompressed video and
  10.      audio
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      aaaavvvvccccaaaappppttttuuuurrrreeee [ ----aaaa # ] [ ----bbbb # ] [ ----cccc # ] [ ----dddd # ] [ ----ffff %s ]
  14.                [ ----hhhh ] [ ----iiii # ] [ ----oooo # ] [ ----pppp # ] [ ----tttt %s ]
  15.                [ ----vvvv vlan_cmd_file ] [ ----wwww # ] [ ----AAAA ] [ ----BBBB ]
  16.                [ ----DDDD ] [ ----FFFF ] [ ----RRRR ] [ ----TTTT ] [ ----VVVV ] [ filename ]
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  19.      ----aaaa <_a_u_d_i_o _f_o_r_m_a_t>
  20.           specifies the file format of the audio data
  21.              1111 ====  no audio (default)
  22.              2222 ====  QuickTime ((((ccccuuuurrrrrrrreeeennnnttttllllyyyy nnnnooootttt iiiimmmmpppplllleeeemmmmeeeennnntttteeeedddd))))
  23.              3333 ====  AIFC
  24.  
  25.  
  26.      ----bbbb <_b_u_f_f_e_r _s_i_z_e>
  27.           allows you to specify the maximum number of buffer elements to be
  28.           allocated. By default, 30 buffers are used, but the value can be
  29.           adjusted for I/O load balancing. The maximum number of buffers which
  30.           can be allocated is limited by the amount of available physical
  31.           memory in the system.
  32.  
  33.  
  34.      ----cccc <_c_o_l_o_r_s_p_a_c_e>
  35.           specifies the image colorspace (see ////uuuussssrrrr////iiiinnnncccclllluuuuddddeeee////ddddmmmmeeeeddddiiiiaaaa////vvvvllll....hhhh or the
  36.           DDDDiiiiggggiiiittttaaaallll MMMMeeeeddddiiiiaaaa PPPPrrrrooooggggrrrraaaammmmmmmmiiiinnnngggg GGGGuuuuiiiiddddeeee for definitions).  The default is
  37.           VVVVLLLL____FFFFOOOORRRRMMMMAAAATTTT____DDDDIIIIGGGGIIIITTTTAAAALLLL____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT (i.e. CCIR601 YCbCr).
  38.              1111 ====  CCIR601 YCbCr (default) [YUV(A) with headroom]
  39.              2222 ====  SMPTE YUV               [YUV(A) full range]
  40.              3333 ====  RP175                   [RGB(A) with headroom]
  41.              4444 ====  RGB                     [RGB(A) full range]
  42.  
  43.  
  44.      ----dddd <_v_i_d_e_o _d_e_v_i_c_e _n_u_m_b_e_r>
  45.           specifies the video device to be used (as reported by vvvvlllliiiinnnnffffoooo).  This
  46.           need not be specified unless you have more than one video device in
  47.           your system; it defaults to 0, i.e. the first device found.
  48.  
  49.  
  50.      ----ffff <_c_a_p_t_u_r_e _f_o_r_m_a_t>
  51.           specifies the capture format of the video data:
  52.              ffffrrrraaaammmmeeeessss ====  uncompressed frames
  53.              ffffiiiieeeellllddddssss ====  uncompressed fields
  54.  
  55.  
  56.      ----hhhh   prints a usage message giving a summary of available flags.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaavvvvccccaaaappppttttuuuurrrreeee((((1111))))                                                      aaaavvvvccccaaaappppttttuuuurrrreeee((((1111))))
  71.  
  72.  
  73.  
  74.      ----iiii <_n_u_m_b_e_r _o_f _f_r_a_m_e_s>
  75.           specifies the number of video images to capture. By default 60
  76.           fields are transferred.
  77.  
  78.  
  79.      ----pppp <_V_L _p_a_c_k_i_n_g _t_y_p_e>
  80.           specifies the pixel packing; see ////uuuussssrrrr////iiiinnnncccclllluuuuddddeeee////ddddmmmmeeeeddddiiiiaaaa////vvvvllll....hhhh for
  81.           definitions.  The default is VVVVLLLL____PPPPAAAACCCCKKKKIIIINNNNGGGG____RRRR444422222222____8888; (This is the most
  82.           efficient selection, since it only takes 16 bits per pixel; all 444
  83.           packing selections take 24 bits per pixel; all 4444 packing
  84.           selections take 32 bits per pixel).
  85.              1111 ====  R242_8 (default)
  86.              2222 ====  242_8
  87.              3333 ====  444_8
  88.              4444 ====  R444_8
  89.              5555 ====  4444_8
  90.              6666 ====  R4444_8
  91.  
  92.  
  93.      ----tttt </_d_e_v/_t_t_y_c#>
  94.           specify the tty device port for serial RS422 V-LAN control
  95.  
  96.  
  97.      ----vvvv <_V-_L_A_N _c_o_m_m_a_n_d _f_i_l_e>
  98.           instructs the program to parse the specified file for V-LAN commands
  99.           and to issue them immediately.
  100.  
  101.  
  102.      ----wwww <_s_c_a_t_t_e_r _g_a_t_h_e_r>
  103.           specifies the number of images to simultaneously write to disk using
  104.           _w_r_i_t_e_v(_2)
  105.  
  106.  
  107.      ----AAAA   abort if any image is dropped (when a VL sequence lost event is
  108.           generated).
  109.  
  110.  
  111.      ----BBBB   calculates the video disk I/O performance and prints the results
  112.           after the data is captured to disk.
  113.  
  114.  
  115.      ----DDDD   enables loquacious output for debugging purposes.
  116.  
  117.  
  118.      ----FFFF   swap field dominance (works only in fields mode).
  119.  
  120.  
  121.      ----RRRR   enables Rice encoding (DIVO only).
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. aaaavvvvccccaaaappppttttuuuurrrreeee((((1111))))                                                      aaaavvvvccccaaaappppttttuuuurrrreeee((((1111))))
  137.  
  138.  
  139.  
  140.      ----TTTT   trigger with VITC.
  141.  
  142.  
  143.      ----VVVV   enables verbose mode and prints the values of parameters used to
  144.           setup the hardware for audio and video transfers.
  145.  
  146.  
  147.      <<<<ffffiiiilllleeeennnnaaaammmmeeee>>>>
  148.           specifies the name of the file to store the video data.  If the ----aaaa3333
  149.           option is chosen audio data will be stored in a separate audio file,
  150.           ffffiiiilllleeeennnnaaaammmmeeee....aaaaiiiiffffcccc.  If the files already exist they will be truncated.
  151.  
  152. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  153.      The utility aaaavvvvccccaaaappppttttuuuurrrreeee uses the Digital Media libraries to record a
  154.      sequence of video images input from a Silicon Graphics video device.
  155.      Audio data can also be captured in a separate AIFC file with the ----aaaa
  156.      option.  If the audio and video hardware are locked to a common external
  157.      reference signal the audio and video data are guaranteed to be
  158.      synchronized.
  159.  
  160.      aaaavvvvccccaaaappppttttuuuurrrreeee is best suited to store large volumes of audio and video data
  161.      in realtime.  This is possible if a striped logical volume disk array of
  162.      sufficient size and configuration is used with the XFS file system.  The
  163.      logical volume, xxxxllllvvvv____mmmmggggrrrr and xxxxllllvvvv____aaaasssssssseeeemmmmbbbblllleeee, and file system, mmmmkkkkffffssss____xxxxffffssss,
  164.      administration tools to configure your disk array.  Another set of
  165.      production utilities, ddddiiiisssskkkkaaaalllliiiiggggnnnn and ddddiiiisssskkkkppppeeeerrrrffff are also available and make
  166.      an otherwise daunting task much simpler to perform.
  167.  
  168.      Files created with this utility will be written in the QuickTime file
  169.      format.  See ////uuuussssrrrr////sssshhhhaaaarrrreeee////ssssrrrrcccc////ddddmmmmeeeeddddiiiiaaaa////mmmmoooovvvviiiieeee for details on how to create and
  170.      edit QuickTime files using the SGI movie library.
  171.  
  172.      The size of a video image is determined by the combination of the capture
  173.      mode, fields or frames, colorspace, and packing.  The image size and
  174.      video format are then used to compute the required data transfer rate.
  175.      The video input timing and format must be set beforehand with vvvvccccpppp.  If
  176.      audio input is selected with the ----aaaa option the default audio device is
  177.      used.  The audio control parameters can be adjusted with aaaappppaaaannnneeeellll.
  178.  
  179.      aaaavvvvccccaaaappppttttuuuurrrreeee can be run in two ways, burst mode or stream mode.  In stream
  180.      mode it is assumed that the disk array onto which the data will be
  181.      recorded has been performance tested for the specified data format.  The
  182.      video data is recorded directly to a file through a small fifo in memory
  183.      as defined by the ----bbbb buffer size option.  If the disk device is not setup
  184.      for real-time capture the ----bbbb option can be used to record in batch mode
  185.      fashion using as many buffers as can be stored in memory with frame
  186.      accurate control in small intervals over the desired duration of time.
  187.  
  188.      The ----vvvv option specifies a text file containing V-LAN edit commands.
  189.      Robust error checking is not performed, therefore, unpredictable behavior
  190.      should be expected if invalid V-LAN commands are issued or if the
  191.      commands are issued in the wrong order.  Permissions and ownership of the
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. aaaavvvvccccaaaappppttttuuuurrrreeee((((1111))))                                                      aaaavvvvccccaaaappppttttuuuurrrreeee((((1111))))
  203.  
  204.  
  205.  
  206.      command file must be properly set.  If V-LAN control is chosen and the CCCCOOOO
  207.      ((((CCCCooooiiiinnnncccciiiiddddeeeennnncccceeee OOOOnnnn)))) and SSSSCCCC ((((SSSSeeeetttt CCCCooooiiiinnnncccciiiiddddeeeennnncccceeee)))) commands are issued the GPI
  208.      input of the video device must be connected to the V-LAN transmitter to
  209.      accurately initiate the data transfer.  This option should be used in
  210.      conjunction with the ----tttt flag.  A special cable must be constructed for
  211.      the trigger input.  See AAAAppppppppeeeennnnddddiiiixxxx AAAA of the DDDDIIIIVVVVOOOO XXXXIIIIOOOO BBBBooooaaaarrrrdddd OOOOwwwwnnnneeeerrrr''''ssss GGGGuuuuiiiiddddeeee
  212.      for details.
  213.  
  214. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  215.      avplayback(1), diskalign(1), diskperf(1), memtovid(1), orion(1),
  216.      vidtomen(1)
  217.  
  218. NNNNOOOOTTTTEEEESSSS
  219.      aaaavvvvccccaaaappppttttuuuurrrreeee runs in "compatibility mode" when using the Octane Digital
  220.      Video board with Irix 6.4.  This is due to the evolution of the VL API.
  221.      The DIVO board supports the new API on Irix 6.4, but Octane Digital Video
  222.      will not support the new API until Irix 6.5.  Consequently, there is a
  223.      requirement to map the colorspace and packing specified in the new API
  224.      model back to the format and packing model of the old API; unfortunately,
  225.      not all combinations are supported.  Refer to the aaaavvvvccccaaaappppttttuuuurrrreeee source in
  226.      ////uuuussssrrrr////sssshhhhaaaarrrreeee////ssssrrrrcccc////ddddmmmmeeeeddddiiiiaaaa////ttttoooooooollllssss.
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.